home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-19 / r12_386.c2 < prev    next >
Text File  |  1993-05-10  |  53KB  |  1,369 lines
  1.      =============================================================
  2.         README.DOC - AutoCAD Release 12 c2 for AutoCAD 386
  3.      =============================================================
  4.  
  5.                General Information
  6.      
  7.                 March 9, 1993
  8.  
  9.     ======================================================================
  10.  
  11.  
  12.     CONTENTS
  13.     ========
  14.  
  15.     What's New in Release 12 c2
  16.  
  17.     Platform-Independent Information - General Notes
  18.  
  19.     Platform-Specific Information - AutoCAD 386
  20.  
  21.     R12 Questions and Answers
  22.  
  23.     Manual Corrections and Additions
  24.  
  25.     AutoCAD Reference Manual
  26.  
  27.     AutoCAD Customization Manual
  28.  
  29.     AutoLISP Programmer's Reference
  30.  
  31.     AutoCAD Development System Programmer's Reference
  32.  
  33.     AutoCAD Extras Manual
  34.  
  35.     Bonus CD-ROM Information
  36.  
  37.     ======================================================================
  38.  
  39.  
  40.     See the following documents for more README information:
  41.  
  42.     README.DRV      Contains additional information on ADI 4.2 device drivers.
  43.  
  44.     README.ADS      Describes the text files that explain how to compile,
  45.             link, and debug AutoCAD Development System (ADS)
  46.             Applications, and tells where to find them.
  47.  
  48.     README.AME      Contains additional information on the AutoCAD Advanced
  49.             Modeling Extension Release 2.1 (AME R2.1).
  50.  
  51.     README.ASE      Contains additional information on the AutoCAD SQL
  52.             Extension (ASE).
  53.  
  54.     README.AVE      Contains additional information on AutoCAD Render.
  55.  
  56. -------------------------------------------------------------------------------
  57.  
  58.     
  59.     WHAT'S NEW IN RELEASE 12 C2
  60.     ===========================
  61.  
  62. Q1:     What's New?
  63.  
  64.     AutoCAD's Plotter drivers can now be configured for a logical network 
  65. device -- or "captured port" (like LPT1) -- instead of a physical device.
  66.  
  67.  
  68.     During configuration, the port device names LPT1:, LPT2:, and
  69.     LPT3: are listed along with the port addresses in hexadecimal
  70.     of the actual available physical ports.  If you choose a device
  71.     name that is "captured" for network printing, AutoCAD will
  72.     honor the network redirection.  If you choose a port address,
  73.     AutoCAD will always send output to the selected physical port.
  74.  
  75.     You can also send plotter output to a port by plotting to file
  76.     and entering a device name.  Legitimate device names are PRN:,
  77.     LPT1:, LPT2:, LPT3:, COM1:, COM2:, COM3:, COM4:, CON:, and
  78.     AUX:.  These device names can be entered in upper or lower
  79.     case, with or without the trailing colon.
  80.  
  81.     If you are using dialog boxes, these device names can be
  82.     selected in the Create Plot File dialog box under
  83.     "Directories".  If you are using Microsoft Lan Manager, device
  84.     names of network redirected ports do not appear in the dialog
  85.     box.
  86.  
  87.  
  88.     Network support has been improved by sending plots to multiple spool 
  89. queues for different plotters on the same network.
  90.  
  91.     Updated documentation for these new plotting facilities can be 
  92. found in the Platform Specific section of this readme.
  93.  
  94.     International versions that have a hardware lock now provide for
  95. server authorization (for Novell networks only).  This allows customers
  96. running AutoCAD 386 Release 12 with hardware locks to have a "floating"
  97. license for concurrent usage.  The minimum number of nodes for the network
  98. has been set to five. (Note -- This requires a special hardware lock. Please
  99. consult the AutoCAD Novell Server Lock Documentation)
  100.  
  101.     SQL drivers for INFORMIX 4.1 and ORACLE 6.0 have been added.  These 
  102. were previously available in the SUN version of AutoCAD only.
  103.  
  104. Q2:     What problems have been corrected?
  105.  
  106.     The c2 update eliminates problems encountered during simultaneous
  107. access of the ACAD.PWD file by contending nodes on network installations.
  108.  
  109.     The R12LAN patch has been included, which corrects file access
  110. problems found with combinations of MS-DOS 5.0 and many popular networks.
  111.  
  112.     The IRQ7 patch has been included, which avoids Phar Lap errors 10025 and
  113. 10026 on some "clone" 486 computers.  
  114.  
  115.     AutoCAD 386 Release 12 can now run under OS/2 2.0.
  116. Note: this requires an OS/2 Service Pack update from IBM.  For further 
  117. infomation, please call IBM HelpWare at 800-722-2227. Note -- OS/2 2.0
  118. is not a supported environment, however our customers seem to be happy
  119. running AutoCAD 386 in an OS/2 2.0 DOS box.
  120.  
  121.     The c2 update corrects a problem with the programs in ACADAPP, 
  122. including DDCHPROP and DDMODIFY, which previously caused AutoCAD to reject 
  123. the functions and report error messages during the QSAVE and END commands.
  124.  
  125.     The plot dialogue now converts fractional scales to full decimal 
  126. accuracy.
  127.  
  128.     AutoCAD can now be fully configured through a script. A 
  129. configuration script will no longer prompt "Press Return for more."
  130.  
  131.     Entities in external reference files, especially filled regions, now
  132. do not plot when the layer is frozen.
  133.  
  134.  
  135.     The integrity of linetypes is maintained in Paper Space viewports, 
  136. regardless of the LTSCALE setting and ZOOM factor.
  137.  
  138.     The Advanced Modeling Extension, AME 2.1, has been updated to
  139. improve the accuracy of mass properties and moments of inertia, to remove 
  140. dead regions when using SOLIDIFY, and to explode blocks correctly with 
  141. WBLKSOL.LSP.
  142.  
  143. DIGITIZER Driver Updates
  144.  
  145.     The c2 release includes earlier c1 updates which improve the
  146. performance of all drivers, offer smooth crosshair movement in very large 
  147. drawings, and allow access to older Hitachi models.
  148.  
  149.     Numonics:  The driver solves intermittent problems with the pick button.
  150.  
  151.     Summagraphics:  The driver eliminates jumpy crosshairs on the 
  152.         SummaSketch II with a 16 - button puck.
  153.  
  154. PLOTTER Driver Updates
  155.  
  156.     The c2 release includes earlier c1 updates which improve the speed of 
  157. all plotter and printer drivers.  The DEFPOINTS layer is no longer plotted.
  158.  
  159.     Houston Instruments:  Pen changes are handled properly, and entity 
  160.         colors are plotted correctly.  
  161.  
  162.     CalComp:  Corrects improper pen changes, which were causing
  163.         multicolored text and lines.  Fixes problems with 
  164.         solid fill regions and omissions of polylines.
  165.  
  166.     Hewlett-Packard HP-GL/2:  Pen changes are handled properly.  Fixes 
  167.         problems with solid fill regions and omissions of polylines.
  168.  
  169.     PostScript:  Pen assigments are handled properly.  Fixes problems 
  170.         with solid fill regions and omissions of polylines.
  171.  
  172.     Raster File Formats:  Configuration for only one pen is now allowed.  
  173.         Also allows multiple pen widths, and pen width definition 
  174.         is written to the output file.  The driver now supports 
  175.         16-million color output or 256 shades of gray-scale 
  176.         (for .EPS files).
  177.  
  178.     HP LaserJet:  Fills solid regions properly (rather than like a 
  179.         hatch pattern) when plotting at 300 dots per inch.
  180.  
  181.  
  182. Q3:     What documentation has been updated for this release?
  183.  
  184.     A Network Hardware Lock Notice; included in all International 
  185. networked copies of AutoCAD.
  186.  
  187.     The printed manuals have not been updated for this release; only the 
  188. readme files have changes.  See readme.doc, readme.ads, readme.drv, 
  189. readme.ame, and readme.ave for the latest information.
  190.  
  191.  
  192. ------------------------------------------------------------------------------
  193.  
  194.     GENERAL NOTES
  195.     =============
  196.  
  197.     - Backwards Incompatibility -- PostScript Fonts
  198.  
  199.     PostScript fonts shipping with Release 12 C2 are not compatible
  200.     with the original Release 12 version of AutoCAD.  Do not use the
  201.     fonts supplied in this C2 version with your original Release 12
  202.     product as these fonts will cause AutoCAD to abort.
  203.  
  204.  
  205.     - Using Custom Menus
  206.  
  207.     Many Release 12 features are implemented as external ADS and AutoLISP
  208.     applications. These applications are made available to you by the
  209.     loading of the file acadr12.lsp. This file is automatically loaded when
  210.     the standard menu that is installed with Release 12 (acad.mnu) is
  211.     loaded.  If acad12.lsp is not loaded, many features, such as the region
  212.     modeler, AVE Render, and various dialogues, will not be available.
  213.  
  214.     If you are using an older menu, or any menu other than the one
  215.     installed with AutoCAD Release 12, you must make sure that acadr12.lsp
  216.     is loaded.  To load acadr12.lsp, insert the following line in the
  217.     menu's .mnl file, if it exists, or in acad.lsp:
  218.  
  219.     (load "acadr12")
  220.  
  221.  
  222.     - Entity Sorting/Drawing Order
  223.  
  224.     The SORTENTS system variable determines whether or not entities are
  225.     processed in database order by various AutoCAD operations. By default,
  226.     this is set to 96 (entity sorting for plotting and PostScript output
  227.     only). If it is important for the display and selection of entities to
  228.     have a predictable order, you can change the setting of SORTENTS as
  229.     desired. However, specifying sorting for additional types of AutoCAD
  230.     operations can significantly affect AutoCAD's performance in large
  231.     drawings (especially the time required for a REGEN, if bit value 16 is
  232.     set in SORTENTS). See  "Entity Sort Method..." on page 29 in the AutoCAD
  233.     Reference Manual.
  234.  
  235.  
  236.     - AutoCAD Release 12 Memory Use
  237.  
  238.     In Release 12, AutoCAD makes more aggressive use of memory than ever
  239.     before.  Various commands such as Hide, Regen, and Render use memory
  240.     intensively and in return either run faster or offer extended
  241.     capabilities.  Because of these changes, optimizing memory use and the
  242.     location of temporary and paging files is increasingly important.
  243.  
  244.     See "AutoCAD 386 Memory Use" in the AutoCAD Interface, Installation,
  245.     and Performance Guide for details.  In addition, see the corrections
  246.     and addenda related to TREEMAX, ACADPAGEDIR, ACADMAXPAGE, and the
  247.     placement of temporary files noted below in this document.
  248.  
  249.  
  250.     - AVE Render and New Drawings
  251.  
  252.     You cannot create a completely empty new drawing if AVE Render is
  253.     loaded. If you want to load a complete DXF or IGES file when AVE Render
  254.     is loaded, you must first unload AVE Render. To do so, select Unload
  255.     Render from the Render pull-down or use the following command line
  256.     syntax:
  257.  
  258.      Command: (xunload "averendr")
  259.  
  260.     Then use the NEW command to obtain a new drawing. (Note: If your configured
  261.     prototype drawing is not an empty one, you'll also need to select the "No
  262.     Prototype" toggle in the New Drawing dialogue box.)
  263.  
  264.  
  265.     - Automatic Timed Save Feature
  266.  
  267.     The new Automatic Timed Save feature has replaced the Spacer File
  268.     mechanism previously used by AutoCAD to reserve hard disk space for the
  269.     drawing currently being edited. This feature, common to most programs,
  270.     saves your drawing file on a regular, user-defined, interval. See
  271.     "Automatic Timed Save" on page 79 in the AutoCAD Reference Manual.
  272.  
  273.  
  274.     - Moving the AutoCAD Program Files
  275.  
  276.     If you move your AutoCAD program files to a different directory after
  277.     initial configuration, you will need to reconfigure AutoCAD. This is
  278.     because the entire path to the drivers is saved in the acad.cfg file.
  279.  
  280.  
  281.     - Quitting a Drawing from a Script
  282.  
  283.     Scripts do not call the Drawing Modification dialogue box that appears
  284.     when you issue QUIT, NEW, or OPEN from a drawing with unsaved changes. A
  285.     script that uses QUIT, NEW, or OPEN should follow these commands with Y
  286.     (discard all changes) or N (don't discard changes) -- not with S (Save
  287.     Changes) or D (Discard Changes).
  288.  
  289.  
  290.     - Release 11 Compatibility with Release 12
  291.  
  292.     Users of Release 11 and Release 12 can freely exchange drawing files,
  293.     without any required file conversion. However some support files, such as
  294.     the R12 acad.mnu file and many AutoLISP/ADS programs, are not downwardly
  295.     compatible with R11. If you plan to intermix or exchange R11 and R12
  296.     drawings, we recommend that you keep your R11 support files accessible.
  297.  
  298.     The \r11supp directory contains a self-extracting compressed file
  299.     containing many of the R11 support files. When this file is executed (make
  300.     the \r11supp directory current and enter `r11supp' at the DOS prompt), it
  301.     "expands" into 36 files totaling approximately 730K bytes in size.
  302.  
  303.  
  304.     - TABLET Command Compatibility
  305.  
  306.     Due to changes in the TABLET Cfg and TABLET Cal commands, scripts, menu
  307.     items, the AutoLISP (command) function, and the ADS ads_command() function
  308.     may now supply input at the "Digitize point:" prompts of these commands.
  309.     Where previously AutoCAD waited for the user to digitize a point at these
  310.     prompts, now it is necessary to supply explicit pauses to make it do so.
  311.     Since scripts have no mechanism for pausing, these commands should not be
  312.     used in a script.
  313.  
  314.     See the section entitled "TABLET command", starting on page 94 of the
  315.     AutoCAD Reference Manual, for a complete description of the new tablet
  316.     calibration options. Also see the AutoLISP Programmer's Reference and
  317.     the ADS Programmer's Reference for information on the (tablet) and
  318.     ads_tablet() functions.
  319.  
  320.  
  321.     - UNNAMED drawings
  322.  
  323.     Prior to Release 12 it was impossible to start a drawing without
  324.     naming it. With Release 12, when you start AutoCAD without
  325.     providing a drawing name, you are editing a drawing named "UNNAMED" 
  326.     until you specifically name it with SAVE, SAVEAS, or other commands that
  327.     require a name for the drawing. If you plot this drawing to
  328.     a file before naming it and don't supply an explicit name for the plot
  329.     file, it will be named unnamed.plt. Also, in the unlikely event that
  330.     you crash, AutoCAD gives you the option to save the drawing. If this
  331.     drawing has not yet been named, AutoCAD saves it as unnamed.dwg.
  332.  
  333.  
  334.     - Using Files from a Read-Only Directory
  335.  
  336.     By default, AutoCAD creates temporary paging files in the same
  337.     directory as the current drawing. If you have not changed the default
  338.     configuration and you attempt to open a drawing in a read-only
  339.     directory you will get the following message:
  340.  
  341.     +----------------------------------------------------------------+
  342.     |                       AutoCAD  Alert                           |
  343.     +----------------------------------------------------------------+
  344.     |  To access files in a read-only directory, you must configure  |
  345.     |  a temporary file location other than  DRAWING                 |
  346.     |                                                                |
  347.     |                           [ OK ]                               |
  348.     +----------------------------------------------------------------+
  349.  
  350.     Examples of read-only media include write-protected floppy disks,
  351.     read-only network directories, and CD-ROMs. To open a drawing in a
  352.     read-only directory (or drive), you will need to specify the name of a
  353.     writable directory where AutoCAD can create temporary paging files.
  354.     Option 5 of the Configure Operating Parameters submenu of the Main
  355.     Configuration menu lets you do this. See your AutoCAD Interface,
  356.     Installation, and Performance Guide (and later sections of this README)
  357.     for more information on temporary paging files.
  358.  
  359.  
  360.     - Programming with the Get File Dialogue
  361.  
  362.     The AutoCAD Development System Programmer's Reference manual (p 156)
  363.     states "The string in the result argument, result->resval.rsting, must
  364.     point to a memory area large enough to store a pathname string."  This
  365.     is erroneous.
  366.  
  367.     The ads_getfiled() function does not always return a pathname.  If the
  368.     user dismisses the dialogue by pressing the "Type It" button, the
  369.     dialogue returns an integer value equal to 1.  For this reason it is
  370.     necessary for the ADS library to allocate the memory needed to store
  371.     the pathname if a pathname is returned.  If the caller attempts to
  372.     allocate a memory buffer for this purpose, the pointer passed into
  373.     ads_getfiled will be ignored and the buffer may become inaccessible to
  374.     the caller.
  375.  
  376.     According to the AutoCAD Development Systems Manual, and the AutoLISP
  377.     Programmers Reference Manual, if the flags bit 1 is set (Value = 2),
  378.     the 'Type it' button will be disabled.  This implies that the
  379.     programmer would not need to test for the return values caused by the
  380.     user pressing this button.
  381.  
  382.     However, if the NULL display driver is configured, ads_getfiled() and
  383.     (getfiled) always returns these values - no matter what the flags
  384.     setting is.  Therefore , the programmer must test for these values, even
  385.     if flags is set to 2.
  386.  
  387.     - Executing Lisp Functions with the same name as an icon menu
  388.  
  389.     This can cause the screen menu area to be overwriten. Our recommendation
  390.     for people developing custom icon menus is to prefix the icon
  391.     menu name with "ICON_" to avoid any conflicts with Autolisp functions.
  392.  
  393.     - AutoCAD Color Dialog
  394.  
  395.        AutoLISP:  (acad_colordlg colornum [flag [layer_colornum]])
  396.  
  397.        If the optional "flag" argument is supplied and is non-nil, the layer
  398.        color may also be supplied as the third argument.
  399.  
  400.        Examples:  (acad_colordlg 1)       ; default color is 1; BYLAYER and
  401.                         BYBLOCK okay
  402.           (acad_colordlg 2 T)     ; default color is 2; BYLAYER and
  403.                         BYBLOCK okay
  404.           (acad_colordlg 3 nil)   ; default color is 3; BYLAYER and
  405.                         BYBLOCK not allowed
  406.           (acad_colordlg 4 T 5)   ; default color is 4; BYLAYER and
  407.                         BYBLOCK okay, layer's color is 5
  408.  
  409.        ADS:       acad_colordlg colornum [flag [layer_colornum]])
  410.  
  411.        If the optional "flag" argument is supplied and is not RTNIL, the layer
  412.        color may also be supplied as the third argument.
  413.  
  414.        Example:   struct resbuf *rb, rslt;
  415.           rb = ads_buildlist(RTSTR, "acad_colordlg",
  416.                      RTSHORT, 4,  ; arg1 - default color
  417.                      RTT,         ; arg2 - BYLAYER/BYBLOCK okay
  418.                      RTSHORT, 5,  ; arg3 - layer color
  419.                      RTNONE);
  420.           ads_invoke(arglist, rslt);
  421.  
  422.  
  423.  
  424.     PLATFORM-SPECIFIC INFORMATION - 386
  425. ========================================================
  426.  
  427. Dos Extender Version
  428. ====================
  429.  
  430. The version of the Phar Lap Dos Extender in R12 C2 is "4.1_ACAD2." This
  431. includes the AutoCAD patches necessary to run in an OS/2 2.0 Dos Box.
  432. You will still need to install the OS/2 2.0 Service Pack or OS/2 2.1
  433. in order to get the necessary changes for OS/2 2.0 itself.
  434.  
  435.  
  436. Font Mapping
  437. ============
  438.  
  439. In Release 12 C2, the PostScript fonts eur_____.pfb and euro____.pfb 
  440. now map to the DOS 850 code page.  Prior to this release, these two
  441. fonts mapped to the ISO 8859-1 code page.  As a result of this change, 
  442. 8-bit characters entered using these two fonts may map differently in
  443. Release 12 C2.
  444.  
  445.  
  446. Novell Issues(International Version)
  447. =============
  448.  
  449. If you are running the International Version of AutoCAD 386 with the
  450. Novell floating license server and have a printer attached to the
  451. Rainbow lock on server, we recommend using Novell "pserver.nlm" version
  452. 1.27 or higher.
  453.  
  454. If you are printing through the Network Lock attached to a Novell
  455. Server, do not use the Novell feature "AUTOENDCAP."
  456.  
  457. Lantastic Issues
  458. ================
  459.  
  460. In order to share a common copy of "acad.exe" on a lantastic
  461. server, you need:
  462.     
  463.     * Appropriate number of AutoCAD licenses.
  464.     * You must not install "share" on the server.
  465.  
  466.  
  467. ADS_DRAGGEN
  468. ============
  469.  
  470. The ads_draggen function in R12 C0 and R12 C1 of AutoCAD didn't
  471. provide the sample point or the final selection point in the same
  472. coordinate system as other ADS functions returning points.  This
  473. functions now provides both sample and final selection points in User
  474. Coordinates.  Applications written for a previous R12 release may
  475. behave differently when run with this release.
  476.  
  477. The ADS sample program, dragger.c has not been updated to reflect this
  478. change.  The global ads_point variable 'Base' and the ads_point 'pt',
  479. in the dragsampler function, must be transformed from User Coordinates
  480. to World Coordinates before they are used.
  481.  
  482.  
  483. New Capabilities for the ACADPLCMD Environment Variable
  484. --- ------------ --- --- --------- ----------- --------
  485.  
  486.  
  487. The ACADPLCMD environment variable specifies a command that is executed
  488. whenever AutoCAD completes a plot to the special file name AUTOSPOOL. For
  489. example, you can use ACADPLCMD to initiate plotting, queue the plot file to
  490. a plot spooler, or notify a system operator that a plot file has been
  491. generated and is ready to plot.
  492.  
  493. AutoCAD expands special percent characters in the string specified by the
  494. ACADPLCMD environment variable before executing the command. The expansion
  495. of special percent characters in the ACADPLCMD environment variable has
  496. been enhanced by
  497.  
  498.   - adding new percent characters
  499.   - allowing multiple occurrences of percent characters
  500.   - allowing capitalized percent characters
  501.  
  502. These enhancements to ACADPLCMD make it easier for you to spool and print
  503. over networks to multiple plotters. The percent characters %s and %% have
  504. not changed from the previous release of AutoCAD.
  505.  
  506. See the "AutoCAD Interface, Installation, and Performance Guide" for
  507. instructions on using the ACADPLCMD environment variable.
  508.  
  509. NOTE: On DOS systems, the command line length limit is approximately 125
  510. characters.  You might exceed the limit if you combine several special
  511. percent characters in an ACADPLCMD string.
  512.  
  513. These are the percent characters that AutoCAD expands when you use
  514. ACADPLCMD:
  515.  
  516. %c or %C
  517.  
  518. This is replaced with the plotter description. The description is the user-
  519. specified description of the plotter entered during plotter configuration.
  520. For the current plotter, the plotter description is in the AutoCAD system
  521. variable PLOTID. When AutoCAD expands %C, it replaces all sequences of one
  522. or more non-alphanumeric characters (language dependent characters) with a
  523. single underscore. If the plotter doesn't have a description (PLOTID is
  524. ""), AutoCAD removes the %C before expanding the percent characters in the
  525. ACADPLCMD value. For example, if ACADPLCMD is "%L %C %D" and the current
  526. plotter doesn't have a description, AutoCAD removes the %C and expands only
  527. the %L and the %D.
  528.  
  529. If your company has several of the same model plotters with different
  530. configurations (for example, different pen setups), you can use the plotter
  531. description to specify which plotter to use.
  532.  
  533. Users can change the plotter description during the AutoCAD plotter
  534. configuration. Users cannot change the plotter model (%M) or plotter name
  535. (%N).
  536.  
  537.  
  538. %d or %D
  539.  
  540. Specifies AutoCAD drawing name including the full path and extension. The
  541. drawing name without the extension is in the AutoCAD system variable
  542. DWGNAME, and the path is in DWGPREFIX.
  543.  
  544. This can be up to 65 characters under DOS. You might exceed the maximum
  545. command line length when using this percent character with others under
  546. DOS.
  547.  
  548.  
  549. %e or %E
  550.  
  551. Specifies the equal sign (=). The DOS SET command does not let you use an
  552. equal sign in the value of an environment variable. With %E, you can
  553. execute a command that contains an equal sign under DOS.
  554.  
  555.  
  556. %h or %H
  557.  
  558. Returns the height of the plot area in the selected plotting units. For
  559. example, if the AutoCAD plot area is 203.20mm high and 266.70mm wide,
  560. AutoCAD replaces %H with 203.2000. The height is specified to four decimal
  561. places.
  562.  
  563. The paper height and width (%W) can be useful for sorting plot files into
  564. queues of plots on a single paper size.
  565.  
  566.  
  567. %i or %I
  568.  
  569. This becomes the first letter of the plot units. The letter is "I" if you
  570. select inches as the plot units; it is "M" if you select metric.
  571.  
  572. NOTE: The letters are NOT translated for foreign language versions of
  573. AutoCAD.
  574.  
  575.  
  576. %l or %L
  577.  
  578. This is replaced with the AutoCAD login name. The login name is in the
  579. AutoCAD system variable LOGINNAME.
  580.  
  581. When AutoCAD expands %L, it replaces all sequences of one or more non-
  582. alphanumeric characters (language dependent characters) with a single
  583. underscore.
  584.  
  585.  
  586. %m or %M
  587.  
  588. This returns the AutoCAD plotter model. The model name is the name AutoCAD
  589. lists during configuration. When AutoCAD expands %M, it replaces all
  590. sequences of one or more non-alphanumeric characters (language dependent
  591. characters) with a single underscore. For example, if you use the model
  592. "HP LaserJet II w/ 1.5 Mbytes," AutoCAD replaces %M with this string:
  593.  
  594.    HP_LaserJet_II_w_1_5_Mbytes
  595.  
  596. Depending on the number and type of plotters you have, you can use this
  597. percent character to specify which plotter should receive a plot file. You
  598. can also use the plotter description (%C) or the plotter name (%N).
  599.  
  600.  
  601. %n or %N
  602. This becomes the plotter name. The plotter name is the name AutoCAD uses to
  603. identify the manufacturer and type of plotter. When AutoCAD expands %N, it
  604. replaces all sequences of one or more non-alphanumeric characters (language
  605. dependent characters) with a single underscore. For example, if you use the
  606. plotter named "Hewlett-Packard (PCL) LaserJet ADI 4.2 - by Autodesk,"
  607. AutoCAD replaces the %N with this string:
  608.  
  609.    Hewlett_Packard_PCL_LaserJet_ADI_4_2_by_Autodesk
  610.  
  611. If you only have a few plotters from different manufacturers, you can use
  612. this percent character to specify which plotter should receive a plot file.
  613. Some device drivers support only a single plotter, and others support
  614. several models. You can also use the plotter description (%C) or the
  615. plotter model (%M).
  616.  
  617.  
  618. %p or %P
  619.  
  620. This is replaced with the plotter number. During configuration, AutoCAD
  621. assigns a number to a configured plotter and lists the plotters in this
  622. order. The value of %P is the number assigned during configuration.
  623.  
  624. The value of %P is one greater than the AutoCAD system variable PLOTTER.
  625. See the "AutoCAD Reference Manual" for more information on PLOTTER.
  626.  
  627. AutoCAD does not permanently assign a number to a configured plotter. If
  628. you have multiple plotters configured and you delete one, AutoCAD assigns
  629. new numbers to the remaining plotters. Use this percent character with
  630. caution.
  631.  
  632.  
  633. %s or %S
  634.  
  635. Specifies the plot spool file name including path and extension.
  636.  
  637.  
  638. %u or %U
  639.  
  640. This is the user name entered when you first install and personalize
  641. AutoCAD. The name is displayed during AutoCAD startup.
  642.  
  643. If your company places a department name and/or mail-stop within the user
  644. name, you can use %U for delivery of the finished plot within the company.
  645.  
  646. When AutoCAD expands %U, it replaces all sequences of one or more non-
  647. alphanumeric characters (language dependent characters) with a single
  648. underscore.
  649.  
  650.  
  651. %w or %W
  652.  
  653. Returns the width of the plotted area in the selected units. For example,
  654. if the AutoCAD plot area is 203.20mm high and 266.70mm wide, AutoCAD
  655. replaces %W with 266.7000. The width is specified to four decimal places.
  656.  
  657. The paper height (%H) and width can be useful for sorting plot files into
  658. queues of plots on a single paper size.
  659.  
  660.  
  661. %%
  662.  
  663. Specifies the percent sign "%".
  664.  
  665.  
  666. Notes on Percent Character Expansion
  667. ------------------------------------
  668.  
  669. For any percent character, you can use the uppercase or the lowercase
  670. letter. AutoCAD treats either percent character in the same manner.
  671.  
  672. All leading and trailing spaces or tabs are removed for all % character
  673. expansions.
  674.  
  675. For the %C, %L, %M, %N, and %U characters, AutoCAD replaces all sequences
  676. of one or more non-alphanumeric characters (language dependent characters)
  677. with a single underscore.
  678.  
  679.  
  680. Example
  681. -------
  682.  
  683. You can use ACADPLCMD to start a plot routine that uses several parameters.
  684. If you enter this SET command at the DOS system prompt and set up AutoCAD
  685. to use ACADPLCMD, AutoCAD starts the batch file plot.bat with the login
  686. name, user name, drawing name, plotter model, and spool file name:
  687.  
  688.   D:\> SET ACADPLCMD=plot.bat %l %u %d %m sp%e%s
  689.  
  690. When a user plots a file, AutoCAD creates a spool file and issues a DOS
  691. command like this (converting the %e to an equals sign):
  692.  
  693.   plot.bat B_Smith Plot_Rm d:\dwgs\r1.dwg HP_LaserJet sp=d:\v1234567.ac$
  694.  
  695. You can enter this in an autoexec.bat file to set ACADPLCMD during startup:
  696.  
  697.   SET ACADPLCMD=plot.bat %%l %%u %%d %%m sp%%e%%s
  698.  
  699. You need two percent signs for the percent characters when you set
  700. ACADPLCMD from a DOS batch file.
  701.  
  702.  
  703.  
  704.  
  705.     - Why don't the Dialogue Box Sliders Work with my Digitizer?
  706.  
  707.     Dialogue box sliders require device drivers written to the newest ADI 4.2
  708.     specification. Contact the maker of your tablet or original supplier of
  709.     the ADI driver for a newer driver.
  710.  
  711.     If you cannot obtain a working ADI 4.2 driver for your digitizer, it
  712.     is possible to use AutoCAD R12 with the old driver by setting the
  713.     IGNORE_DRAGG environment variable.  See the Interface, Installation, and
  714.     Performance Guide for more information.
  715.  
  716.  
  717.     - Using Old ADI Drivers
  718.  
  719.     All drivers must obey a specific naming convention for R12 to find them.
  720.     Digitizer drivers start with DG, Plotter drivers start with PL, Display
  721.     drivers start with DS, and combined Rendering and Display drivers start
  722.     with RC.  R11 protected-mode drivers must be renamed for AutoCAD to
  723.     locate them.  Note:  You may have to use the -priv switch on cfig386 in
  724.     order to use pre-4.1 protected mode drivers. For more information, see
  725.     the Interface, Installation and Performance Guide.
  726.  
  727.  
  728.  
  729.     - Upgrade Installation Information
  730.  
  731.     When upgrading from an earlier release of AutoCAD, we recommend that
  732.     you install Release 12 in a separate directory, rather than installing
  733.     on top of the existing software. This is particularly important if you
  734.     are using the Release 11 AutoCAD Extension for Windows or any
  735.     third-party applications.
  736.  
  737.     If you install on top of an older version, various support files required
  738.     for use with R11 AEW will be overwritten.  The support files needed by
  739.     R11 AEW are installed as part of Release 12.  They are stored in a
  740.     self-extracting compressed file in the \r11supp directory called
  741.     r11supp.exe.
  742.  
  743.     See the 386 Interface, Installation, and Performance Guide for further
  744.     details.
  745.  
  746.  
  747.     - AVE Render and Color Mapping
  748.  
  749.     Display colors with a value of 16 or greater reference the standard
  750.     AutoCAD color map, which, on most displays, is overridden by certain
  751.     rendering operations. If you have assigned these higher-numbered colors
  752.     to your dialogue boxes (with DLGCOLOR), you can avoid potential display
  753.     conflicts by invoking the dialogue from a NON-RENDERED viewport.
  754.  
  755.  
  756.     - DLGCOLOR Command
  757.  
  758.     As supplied, AutoCAD's dialogue boxes use very few colors (this is to
  759.     ensure proper visibility on all types of displays). You can use the
  760.     DLGCOLOR command to liven up the colors of these dialogues considerably
  761.     and to give their buttons a 3D appearance.
  762.  
  763.     You can use DLGCOLOR to create your own color combinations or to choose
  764.     one of several color schemes provided as .DCC (dialogue color
  765.     configuration) support files.  To select one of the supplied color
  766.     schemes, pick "Read file" from the DLGCOLOR dialogue box, and then select
  767.     one of the .DCC files from your SUPPORT directory. To see what a color
  768.     combination looks like on your display, pick "Show..." to display a
  769.     sample dialogue box that uses the color scheme you selected. If you like
  770.     what you see, dismiss the sample dialogue box and pick "OK" in the main
  771.     DLGCOLOR dialogue box. The color scheme you choose is saved in acad.cfg.
  772.  
  773.  
  774.     - Configuring the DOS-Extender Switches for a Networked Environment
  775.  
  776.     In a networked environment, customers frequently prefer to load a single
  777.     copy of the executable on a file server after purchasing multiple licenses.
  778.     AutoCAD provides several configuration options to ensure smooth operation
  779.     in this case. Specifying a network node name, redirecting temporary files
  780.     to local drives, and setting the ACAD and ACADCFG variables to specific
  781.     pathnames can help.
  782.  
  783.     With AutoCAD 386, you may need to account for the DOS-extender settings as
  784.     well.  For example, concurrent users may need to redirect their swap files
  785.     to local drives.  This requires setting the -swapdir parameter.  However,
  786.     this option can be configured only once in the AutoCAD 386 executable.
  787.  
  788.     There is a way around this limitation, since the DOS-extender kernel
  789.     present in AutoCAD 386 allows the specification of "run-time" environment
  790.     variables. The technique:
  791.  
  792.     Configure the AutoCAD 386 executable for a run-time environment
  793.     string by typing:
  794.  
  795.         cfig386  acad.exe  %ACAD386
  796.  
  797.     If you are specifying multiple DOS-Extender switches using cfig386,
  798.     then %ACAD386 must be specified last, e.g.:
  799.  
  800.         cfig386  acad.exe -nopgexp [...] -vscan 20000 %ACAD386
  801.  
  802.     Then, prior to running AutoCAD 386, set the environment variable
  803.     ACAD386 to a string defining the DOS-Extender settings, either by
  804.     typing the following in at a DOS prompt or by using a batch file:
  805.  
  806.         SET ACAD386= -swapdir d:\swapf
  807.  
  808.     Using the above commands, one could configure the acad.exe file residing
  809.     on the file server for a run-time %ACAD386 variable, and have a unique
  810.     batch file on individual workstations that specifies a value for the
  811.     ACAD386 environment variable.  Note that you must configure the AutoCAD
  812.     386 executable first for this to work.
  813.  
  814.  
  815.     - Limitations on the use of the MULTIPLE command
  816.  
  817.     If you use the MULTIPLE command in conjunction with any dialogue box
  818.     command, you will need to issue multiple Ctrl-C's quickly to end the
  819.     command repetition.
  820.  
  821.  
  822.  
  823.     R12 QUESTIONS AND ANSWERS
  824.     =========================
  825.  
  826.  
  827.     Q.  I have script files to do my plotting, but these no longer work.  Why?
  828.  
  829.     A.  Some of the major enhancements to AutoCAD R12 are in the PLOT command.
  830.     Unfortunately, old plotting scripts will no longer work because the
  831.     command has been so completely altered.  To force AutoCAD to follow
  832.     pre-R12 formats, set the system variable CMDDIA to 0.
  833.  
  834.        Command:  cmddia 0
  835.  
  836.     In R12, AutoLISP now remains active during the PLOT command; new
  837.     AutoLISP functions can be written to do an even better job of plotting
  838.     than pre-R12 scripts.  Here is an example of an R12 PLOT command
  839.     written in AutoLISP:
  840.  
  841.        Command:  (command "plot" "e" "n" "filename" "")
  842.  
  843.  
  844.     Q.  AutoCAD doesn't locate any of my drivers during configuration.
  845.     What's wrong?
  846.  
  847.     A.  The environment variable ACADDRV is not set to the directory
  848.     containing the AutoCAD drivers.  By default, the drivers are placed in
  849.     the \drv directory.  See your AutoCAD Interface, Installation, and
  850.     Performance Guide for more information.
  851.  
  852.  
  853.     Q.  When I use the menu I frequently get the error message: "Unknown
  854.     command.  Type ? for list of commands."  What's wrong?
  855.  
  856.     A.  AutoCAD is unable to locate the menu lisp file.  The menu file for R12
  857.     has been broken into two parts, the standard menu file, acad.mnu, and
  858.     the AutoLISP menu file, acad.mnl.  These files must be located in the
  859.     same directory and have like names.  See page 112 of the AutoCAD
  860.     Customization Manual for more information on .mnl files.
  861.  
  862.  
  863.     Q.  What is base.dcl?  Why does AutoCAD report that it cannot be found?
  864.  
  865.     A.  AutoCAD R12 has customizable dialogue boxes.  The definitions for
  866.     these are stored in .dcl files.  The file base.dcl contains basic
  867.     dialogue definitions used in the layout for AutoCAD's internal
  868.     dialogue boxes, as well as items useful to application developers.  If
  869.     AutoCAD cannot find base.dcl it usually means that the AutoCAD
  870.     \support directory has not been added to the ACAD environment
  871.     variable.
  872.  
  873.  
  874.     Q.  Occasionally when I enter AutoCAD, I receive an error message 
  875.     reporting that the digitizer is not responding or Analog 
  876.     Circuitry Failure.  In the past, a PLOT command followed by 
  877.     a Control-C would restart the tablet.
  878.  
  879.     A.  R12 has a new command called REINIT which will reinitialize the 
  880.     digitizer, the plotter, the display, or the .pgp file.  
  881.     NOTE:  You can also use the RE-INIT System Variable, see the AutoCAD 
  882.     Reference Manual for more information.  
  883.  
  884.  
  885.     Q.  I installed AutoCAD R12 but now I have to reconfigure whenever I go
  886.     from R11 to R12 or vice-versa.
  887.  
  888.     A.  If you have two versions of AutoCAD installed on the same computer,
  889.     you must specify a different location for the acad.cfg by using the
  890.     ACADCFG environment variable.
  891.  
  892.  
  893.     Q.  How do I reconfigure AutoCAD now that there is no main menu?
  894.  
  895.     A.  To configure AutoCAD R12, you can either: specify the -R command line
  896.     option to the ACAD executable (ACAD -R), type CONFIG at AutoCAD's
  897.     command prompt, or select Configure from the File pull-down menu.
  898.  
  899.  
  900.     Q.  Where can I get more PostScript fonts?
  901.  
  902.     A.  AutoCAD uses any Type 1 PostScript Fonts.  They are sold by a variety
  903.     of vendors and are available at local computer stores.  See chapter 10
  904.     of the Customization Manual for additional information.
  905.  
  906.  
  907.     Q.  Can I distribute an .shx file which I have compiled from a font
  908.     supplier's .pfb file?
  909.  
  910.     A.  No.  The font supplier's copyright prohibits distribution of any files
  911.     derived from their .pfb files.
  912.  
  913.  
  914.     Q.  Why don't I get PostScript fonts when I plot with PSOUT?
  915.  
  916.     A.  The acad.psf file contains the logical mapping between the AutoCAD
  917.     font name and the PostScript font name.  This font mapping references
  918.     the .shx or .pfb file name and not the AutoCAD style name.  For more
  919.     information refer to the text included in the acad.psf file and
  920.     chapter 10 of the AutoCAD Customization Manual.
  921.  
  922.  
  923.     Q.  Where is the PRPLOT Command?
  924.  
  925.     A.  The PRPLOT command is now part of the PLOT command. Printers and
  926.     printer plotters are handled just like plotters, and can be configured
  927.     by the Configure plotters option of the CONFIG command. All plotter
  928.     and printer plotter drivers are discussed in appendix C of your
  929.     AutoCAD Interface, Installation, and Performance Guide.
  930.  
  931.  
  932.  
  933.     MANUAL CORRECTIONS AND ADDITIONS
  934.     ================================
  935.  
  936.     AutoCAD Reference Manual
  937.     ------------------------
  938.  
  939.     Chapter 6
  940.  
  941.     - "PEDIT Command--Polyline/Mesh Editing", page 243. The following should 
  942.     be added to the discussion of the Join option of PEDIT:
  943.     
  944.     Note: Using the Join option on a curve-fit Polyline removes the curve 
  945.     fitting.
  946.     
  947.     Chapter 13
  948.     
  949.     - "Freeplotting--Using AutoCAD to Plot", page 545. The following should be 
  950.     added to the description of using a script with Freeplotting:
  951.     
  952.     In Freeplot, AutoCAD prompts for the drawing name after the PLOT 
  953.     command is issued.  When plotting from a script, you must provide the 
  954.     drawing name after the PLOT command.
  955.     
  956.     Appendix A
  957.     
  958.     - "PostScript Fonts", page 580.  The name of the PanRoman font "Pan" is 
  959.     incorrect, it should be "Par".
  960.     
  961.  
  962.     - "DDIM", page 643. Contrary to its table entry on page 643 of the AutoCAD
  963.     Reference Manual (May 28, 1992 edition), the DDIM command cannot be used 
  964.     transparently.  It can be used as an ordinary command, or as 
  965.     a DIM subcommand.
  966.  
  967.     
  968.  
  969.  
  970.  
  971.     AutoCAD Customization Manual
  972.     ----------------------------
  973.  
  974.     Chapter 5
  975.  
  976.     - "Shape Descriptions", page 51. The first sentence of the fifth paragraph 
  977.     in this section should be replaced with the following:
  978.  
  979.     Every shape in a particular shape file must have a unique number 
  980.     between 1 and 258 (numbers 256, 257, and 258 are for the symbolic 
  981.     identifiers "Degree_Sign", "Plus_Or_Minus_Sign", and 
  982.     "Diameter_Symbol").
  983.  
  984.  
  985.     Chapter 7
  986.  
  987.     - "Invoking a Script When Loading AutoCAD", page 102.  The following 
  988.     sentence should be added to the Note about Freeplotting:
  989.  
  990.     See the AutoCAD Reference Manual for information on the Freeplot 
  991.     feature.
  992.  
  993.  
  994.     Chapter 11
  995.  
  996.     - "HEADER Section", page 252.  The $DWGCODEPAGE variable is listed as a 
  997.     type 70, this is incorrect it is really a type 3.
  998.  
  999.  
  1000.     - "TABLES Section", page 258.  A portion of the description in the VPORTS 
  1001.     group is incorrect.  
  1002.  
  1003.     The text "... 12 and 22 (view center point, in WCS) ..." should read 
  1004.     as "... 12 and 22 (view center point, in DCS) ...".
  1005.  
  1006.     It should also be noted that the groups 68 (status field) and 69 (ID) 
  1007.     are never saved.
  1008.  
  1009.  
  1010.     AutoLISP Programmer's Reference
  1011.     -------------------------------
  1012.  
  1013.     Chapter 1
  1014.  
  1015.     - "Function Libraries--Automatic Loading", page 15. The following should
  1016.     replace the last sentence in the second paragraph:
  1017.  
  1018.     When a menu file is loaded (either by starting a drawing or issuing
  1019.     the MENU command), AutoCAD searches the directory containing the
  1020.     newly loaded .mnu file for a .mnl file of the same filename. If a
  1021.     matching .mnl file is found AutoCAD loads the AutoLISP code in that
  1022.     file after loading the menu file (e.g., AutoCAD loads the file
  1023.     acad.mnl after loading the acad.mnx compiled menu file).
  1024.  
  1025.     - "Function Libraries--Automatic Loading", page 15. The following should
  1026.     be added to the description of the .mnl file.
  1027.  
  1028.     If a menu file is loaded with the AutoLISP (command) function, its
  1029.     associated .mnl file is not loaded until the entire AutoLISP
  1030.     routine has run to completion.
  1031.  
  1032.  
  1033.     Chapter 4
  1034.  
  1035.     - "(entget)", page 102 and "(entmod)", page 107. These sections should
  1036.     include the following information:
  1037.  
  1038.     Before performing an (entget) or (entmod) on Vertex entities, you
  1039.     should read or write the header (Polyline entity) for the Polyline
  1040.     to which they belong. If the Polyline entity most recently processed
  1041.     is different from the one to which the Vertex belongs, width
  1042.     information (the 40 and 41 groups) can be lost.
  1043.  
  1044.     - "(*error*)", page 111. This incorrectly states that your *error*
  1045.     function should not include any calls to the command function without
  1046.     arguments. This paragraph should be replaced with the following:
  1047.  
  1048.     Your *error* function can include calls to the command function
  1049.     without arguments (i.e., (command) ); this will cancel a previous
  1050.     AutoCAD command called with the command function.
  1051.  
  1052.     - "(grread)", page 121.  Value 16 (bit 4) of the <allkeys> argument is
  1053.     not supported.
  1054.  
  1055.     - "(grread)", page 123. The text "... grread returns a type 11 code ..." 
  1056.     should be replaced with "... grread returns a type 6 or type 11 code ...".
  1057.  
  1058.     - "initget - Keyword Specifications", page 127.  The following
  1059.     information should be added to this section:
  1060.  
  1061.     A legal keyword can contain letters, numbers, or hyphens (-).
  1062.  
  1063.     - "(tblnext)", page 157.  The following note should be added to the 
  1064.     (tblnext) description:
  1065.  
  1066.     Hint: Since the (vports) function returns current VPORT table 
  1067.     information, it might be more appropriate to use (vports) as opposed 
  1068.     to (tblnext).
  1069.  
  1070.  
  1071.     Appendix B
  1072.  
  1073.     - "Entity Group Codes", page 200. The meaning of Text entity group code 41 
  1074.     should be "Relative X-scale factor (optional; default: 1.0)
  1075.  
  1076.  
  1077.     Appendix C
  1078.  
  1079.     - "Error Codes", page 210. The following error code should be added to
  1080.     the "On-line program error codes" table:
  1081.  
  1082.       +-------+--------------------------------------------------------+
  1083.       | Value | Meaning                                                |
  1084.       |-------|--------------------------------------------------------|
  1085.       | 85    | AutoLISP/ADS operation attempted and prohibited while  |
  1086.       |       | a dialogue box was displayed                           |
  1087.       +-------+--------------------------------------------------------+
  1088.  
  1089.  
  1090.  
  1091.     AutoCAD Development System Programmer's Reference
  1092.     -------------------------------------------------
  1093.  
  1094.     Chapter 2
  1095.  
  1096.     - "File" Search, page 57. The third line of code in the example,
  1097.  
  1098.     if (ads_newrb(result) == NULL) {
  1099.  
  1100.     should read as follows:
  1101.  
  1102.     if ((result = ads_newrb(RTSTR)) == NULL {
  1103.  
  1104.  
  1105.     Chapter 3
  1106.  
  1107.     - "Filtering for Extended Entity Data", page 88.  The examples on pages 88 
  1108.     and 89 are incorrect.  They should be replaced with the following 
  1109.     examples: 
  1110.  
  1111.     Example 1:
  1112.  
  1113.     eb1.restype = 0;                 /* Entity type */
  1114.     strcpy(sbuf1, "CIRCLE");
  1115.     eb1.resval.rstring = sbuf1;      /* Circle */
  1116.     eb1.rbnext = &eb2;
  1117.   
  1118.     eb2.restype = -3;                /* Extended entity data */
  1119.     eb2.rbnext = &eb3;
  1120.   
  1121.     eb3.restype = 1001;
  1122.     strcpy(sbuf2, "APPNAME");        /* Application name */
  1123.     eb3.resval.rstring = sbuf2;
  1124.     eb3.rbnext = NULL;
  1125.   
  1126.     /* Select Circles with XDATA registered to APPNAME */ 
  1127.     ads_ssget("X", NULL, NULL, &eb1, ss);
  1128.  
  1129.     Example 2:
  1130.  
  1131.     eb1.restype = 0;                 /* Entity type */
  1132.     strcpy(sbuf1, "CIRCLE");
  1133.     eb1.resval.rstring = sbuf1;      /* Circle */
  1134.     eb1.rbnext = &eb2;
  1135.   
  1136.     eb2.restype = -3;                /* Extended entity data */
  1137.     eb2.rbnext = &eb3;
  1138.   
  1139.     eb3.restype = 1001;
  1140.     strcpy(sbuf2, "APP1");           /* First application name */
  1141.     eb3.resval.rstring = sbuf2;
  1142.     eb3.rbnext = &eb4;
  1143.   
  1144.     eb4.restype = 1001;
  1145.     strcpy(sbuf3, "APP2");           /* Second application name */
  1146.     eb4.resval.rstring = sbuf3;
  1147.     eb4.rbnext = NULL;
  1148.   
  1149.     /* Select Circles with XDATA registered to APP1 and APP2 */
  1150.     ads_ssget("X", NULL, NULL, &eb1, ss);
  1151.  
  1152.     Example 3:
  1153.  
  1154.     eb1.restype = 0;                 /* Entity type */
  1155.     strcpy(sbuf1, "CIRCLE");
  1156.     eb1.resval.rstring = sbuf1;      /* Circle */
  1157.     eb1.rbnext = &eb2;
  1158.  
  1159.     eb2.restype = -3;                /* Extended entity data */
  1160.     eb2.rbnext = &eb3;
  1161.  
  1162.     eb3.restype = 1001;
  1163.     strcpy(sbuf2, "APP1,APP2");      /*  Application names */
  1164.     eb3.resval.rstring = sbuf2;
  1165.     eb3.rbnext = NULL;
  1166.   
  1167.     /* Select Circles with XDATA registered to APP1 or APP2 */
  1168.     ads_ssget("X", NULL, NULL, &eb1, ss);
  1169.  
  1170.     Example 4:
  1171.  
  1172.     eb1.restype = 0;                 /* Entity type */
  1173.     strcpy(sbuf1, "CIRCLE");
  1174.     eb1.resval.rstring = sbuf1;      /* Circle */
  1175.     eb1.rbnext = &eb2;
  1176.  
  1177.     eb2.restype = -3;                /* Extended entity data */
  1178.     eb2.rbnext = &eb3;
  1179.  
  1180.     eb3.restype = 1001;
  1181.     strcpy(sbuf2, "APP[12]");        /*  Application names */
  1182.     eb3.resval.rstring = sbuf2;
  1183.     eb3.rbnext = NULL;
  1184.   
  1185.     /* Select Circles with XDATA registered to APP1 or APP2 */
  1186.     ads_ssget("X", NULL, NULL, &eb1, ss);
  1187.  
  1188.  
  1189.     - "Transforming Selection Sets", page 94. In the second example of the
  1190.     dragsample() function, the declaration of the matrix argument should be
  1191.     as follows (as it is in the first example):
  1192.  
  1193.     ads_matrix matrix;
  1194.  
  1195.     - "Entity Name Functions", page 97. This section should include the
  1196.     following information:
  1197.  
  1198.     If a call to ads_entsel(), ads_nentselp(), or ads_nentsel() returns
  1199.     RTERROR, and you want to know whether the user picked a point that
  1200.     had no entity or simply pressed <CR>, you can inspect the value of
  1201.     the ERRNO system variable. If the user picked an empty point, ERRNO
  1202.     equals 7 (OL_ENTSELPICK). If the user pressed <CR>, ERRNO equals 52
  1203.     (OL_ENTSELNULL). (You can use the symbolic names if your program
  1204.     includes the header file, ol_errno.h.)
  1205.  
  1206.     CAUTION: You should inspect ERRNO immediately after ads_entsel(),
  1207.     ads_nentselp(), or ads_nentsel() returns. A subsequent ADS library
  1208.     call can change or clear the value of ERRNO.
  1209.  
  1210.  
  1211.     - "Anonymous Blocks", page 110.  Lines 5 through 8 of the example at the 
  1212.     bottom of the page are incorrect.  They should be replaced with the 
  1213.     following lines of code:
  1214.     
  1215.     ads_point pnt1 = { 0.0, 0.0, 0.0 };
  1216.     entlist=ads_buildlist(RTDXF0, "BLOCK", 
  1217.                   2, "*ANON", 
  1218.                   10, pnt1,
  1219.                   70, 1,
  1220.                   0);
  1221.  
  1222.  
  1223.     Chapter 4
  1224.  
  1225.     - "ads_entget()", page 145 and "ads_entmod()", page 149. These sections
  1226.     should include the following information:
  1227.  
  1228.     Before calling an ads_entget() or ads_entmod() for Vertex entities,
  1229.     you should read or write the header (Polyline entity) for the
  1230.     Polyline to which they belong.  If the Polyline entity most recently
  1231.     processed is different from the one to which the Vertex belongs,
  1232.     width information (the 40 and 41 groups) can be lost.
  1233.  
  1234.  
  1235.     - "ads_getfiled", p. 156. In the paragraph below figure 4-2, replace the
  1236.     first two sentences with the following sentences:
  1237.  
  1238.     If the dialogue box gets a filename from the user, ads_getfiled() sets
  1239.     the string in the result argument to a string specifying the filename;
  1240.     otherwise, ads_getfiled() sets the string in result to NULL. The
  1241.     ads_getfiled() function allocates the pathname string. Your program is
  1242.     responsible for freeing the string by calling free() (if result is a
  1243.     static buffer) or ads_relrb() (if result is a dynamically allocated
  1244.     buffer).
  1245.  
  1246.  
  1247.     - "ads_getkword", page 160. In the final paragraph on p. 161, replace the
  1248.     words "RTNONE or RTKWORD (for arbitrary input)" with "RTNONE (if the
  1249.     user enters a null response or arbitrary input)".
  1250.  
  1251.  
  1252.     - "ads_getsym", p. 162. Delete the last sentence of the first paragraph,
  1253.     "It also fails if the symbol is not bound, or is bound to nil.", and
  1254.     replace it with the following sentence:
  1255.  
  1256.     If the symbol not bound or is nil, ads_getsym() returns RTNORM and
  1257.     sets the value argument to NULL.
  1258.  
  1259.     Replace the first sentence of the second paragraph with the following
  1260.     sentence:
  1261.  
  1262.     The ads_getsym() function returns RTNORM if it succeeds; if it fails,
  1263.     ads_getsym() returns RTERROR.
  1264.  
  1265.  
  1266.     - "ads_getsym", page. 162. The ads_getsym() function can access AutoLISP
  1267.     symbols that AutoLISP cannot. (Such symbols can only be created by
  1268.     ads_putsym() calls.) This will cause an error in a future upgrade or
  1269.     release of AutoCAD. Your programs should not rely on this capability.
  1270.  
  1271.  
  1272.     - "ads_grread()", page 165. The text "... ads_grread() returns a type 11 
  1273.     code ..." should be replaced with "... ads_grread() returns a type 6 or 
  1274.     type 11 code ...".
  1275.  
  1276.  
  1277.     - "ads_initget() - Keyword Specifications", page 170.  The following
  1278.     information should be added to this section:
  1279.  
  1280.     A legal keyword can contain letters, numbers, or hyphens (-).
  1281.  
  1282.  
  1283.     - "ads_putsym", p. 180. An ads_putsym() call can create a new AutoLISP
  1284.     symbol that AutoLISP cannot access -- for example, by including illegal
  1285.     characters in the symbol name, such as "pair(s". An ads_getsym() call can
  1286.     access such symbols, but they will cause an error in a future upgrade or
  1287.     release of AutoCAD. Your programs should not rely on this capability.
  1288.  
  1289.  
  1290.     - "ads_polar", page 180.  All references to 'ptres' should be changed to 
  1291.     'result'.
  1292.  
  1293.  
  1294.     - "ads_regfunc", page 182.  The following sentence should be added to the 
  1295.     ads_regfunc() description:
  1296.  
  1297.     An external function handler registered by ads_regfunc() must have no 
  1298.     arguments and must return an integer, one of the application result 
  1299.     codes--either RSRSLT or RSERR, as appropriate.
  1300.  
  1301.  
  1302.     Appendix B
  1303.  
  1304.     - "Entity Group Codes", page 255.  The group code 40 is missing from the 
  1305.     ATTRIB entity group.  The following should be added to that section:
  1306.  
  1307.     +-----------+-------+-----------------------------------+
  1308.     | ATTRIB    | 40    | Text height                       |
  1309.     +-----------+-------+-----------------------------------+
  1310.  
  1311.  
  1312.     - "Entity Group Codes", page 258. The meaning of Text entity group code 41 
  1313.     should be "Relative X-scale factor (optional; default: 1.0)
  1314.  
  1315.  
  1316.     AutoCAD Extras Manual
  1317.     ---------------------
  1318.  
  1319.     Chapter 2
  1320.     
  1321.     - "RIEDGE  Edge Detection and Extraction", page 35.  The third sentence of 
  1322.     the first paragraph should be replaced with the following:
  1323.     
  1324.     Specifying values from 1 to 255 set the threshold for RIEDGE 
  1325.     detection.
  1326.  
  1327.  
  1328.     Chapter 3
  1329.  
  1330.     - "Tips and Techniques", page 85-95. This section should include the
  1331.     following subsection:
  1332.  
  1333.        SOLCHP Command
  1334.  
  1335.        While in the SOLCHP command, if you perform any operation that
  1336.        forces the screen to redraw (like entering 'redraw), all of the
  1337.        primitives for the selected solid or region may be displayed.
  1338.        Entering the SOLCHP Instance, Replace, or Delete option while your
  1339.        grid is on will also display all the primitives in some cases.
  1340.  
  1341.  
  1342.  
  1343.      Bonus CD-ROM
  1344.      ============
  1345.  
  1346.     - The AutoLISP routine mmo_edit.lsp lets you interactively test and edit
  1347.     MODEMACRO strings. It displays six edit boxes for entering text strings
  1348.     but only evaluates the first five. To correct this problem revise the
  1349.     AutoLISP file as shown below.
  1350.  
  1351.     Add `l6' to line #121,
  1352.                      (setq mmo (strcat l1 l2 l3 l4 l5))
  1353.     so it reads
  1354.                      (setq mmo (strcat l1 l2 l3 l4 l5 l6))
  1355.  
  1356.     - AutoCAD Lock Utility (CADLOC) Note
  1357.  
  1358.     In Release 12, there is an additional swap file (DOS386 only) which did
  1359.     not exist in R11 and is therefore not removed by cadloc -c (crash
  1360.     recovery).  This file, if it exists following a crash, will normally be
  1361.     located in the root directory of the drive containing the current
  1362.     working directory, or drawing directory.  There will be two files of
  1363.     the same name; one with an extension of '.SWR', and the new one - with
  1364.     no extension.  CADLOC finds and removes the one with the '.SWR'
  1365.     extension, but the other will need to be deleted manually.  The name is
  1366.     a random sequence of letters, which changes each time AutoCAD is run.
  1367.  
  1368.  
  1369.